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The NOVA Editor is a routine allowing for editing of paper tape input to 
produce updated paper tape output . It is most commonly used to modify 
program source tapes in preparation for a new assembly. The Editor executes 
simple command strings requested from the teletype to modify text on either 
a character or a line level. The location of text is facilitated by means 
of string searches . 



Copyright (C) Data General Corp., 1969 093-000018-01 



1. Introduction 

2. Logical Operation 

3 . Commands 

3.1 Notation 

3 . 2 Format 

3.2.1 Single Command 

3.2.2 Command String 

3 . 3 Command Descriptions 

3.3.1 Read (yank) a Page 

3.3.2 Append a Page 

3.3.3 Output (punch) the Buffer 
3 . 3 . U Output Leader or Form Feed 
3.3.5 Output and Read 

3' 3-6 Examine (type out) the Buffer 

3.3.7 Move CP to Beginning of Buffer 

3.3.8 Move CP to End of Buffer 

3.3.9 Move CP 

3.3.10 Delete Characters 

3.3.11 Move CP to Beginning of a Line 

3.3.12 Delete Lines 

3.3.13 Insert Characters 
3-3.1^ String Searches 

3.3.15 Change a String 

3. 3.16 Copy Remainder of Input File 
3.U Special Action Characters 



3.U 


1 


Number of Characters in Buffer 


3,4, 


2 


Number of Lines in Buffer 


3.1 , 


3 


Number of Current Line 


3.4. 


^4 


Insert with Tab 


3,4, 


5 


Last Character Delete 


3.4. 


6 


Erase or Stop Command Execution 


3.4. 


7 


Reset for Input 


4. 




Operating Procedure 


4.1 




General 


4.2 




Input 


4.3 




Editor Output to Teletype 


4.3.1 


Invisible Characters 


4.3. 


2 


Tab and Form Feed 


4.4 




Teletype Selected as Output File 


5. 




Error Detection 


5.1 




Unsuccessful String Search 


5.2 




Parity Error on Input 


5.3 




Edit Buffer Capacity Exceeded 


5.4 




Questionable Command 



APPENDIX A - Command Summary 



ii . 



EDITOR MAHUAL 

1 . Introduction 

The purpose of the Editor is to update an input file to produce an output 
file. This is accomplished by commands issued from the teletype. The commands 
enable the user to delete, insert, and search for strings of text. The command 
structure is versatile enough to allow changes at both the line and character 
levels. String searches provide a convenient means for "both locating and 
replacing characters of text. 

2 • Logical Operati on 

The input file to the Editor is a continuous stream of characters. 
Logi colly , this stream of characters is considered to be segmented into 
pages. A page is a string of characters up to but not including a form 
feed character. A page is logically segmented into lines. A line is a 
string of characters up to and including a carriage return. 

The editing process consists of the following steps: 

1) Read a page from the input file into an edit buffer. 

2) Modify this page based on Editor commands issued from the teletype. 

3) Output this modified page to the output file. 

An implicit character pointer (CP) is maintained by the Editor and is 
used to locate the object string for text modifications. This pointer should 
be thought of as residing between two characters. For example, the CP night 
be positioned as shown below; 



If characters are inserted, they will be placed at the position of CP. 
Insertion of a "1", for example, would give the following string: 

LAB10 : 
CP 

where it is noted that CP now resides after the inserted character. 
3- Commands 
3.1 Ho tat ion 

The following notation will he used in this manual to describe the 
format of Editor commands and the description of text strings. 

A space will be explicitly represented by the symbol M jJ", e.g. 

TWO DWORDS 

A carriage return will be represented by the symbol )< " , e.g. 

LINE01 I- LINEUP ), 
Control codes will be indicated by an up arrow followed by the symbol 
which would have printed if CTRL had not been depressed, e.g. 

tG is the BEL code (007) 
The escape code (033) serves a special function tc the Editor and has no 
non-control counterpart. It will be represented by "$ ;! (in operation, the 
Editor will transmit "$' ; to the teletype whenever escape is input). 

3 . 2 Fo rmat 

3.2.1 Single Command 

A single command has the following format: 

arg code string lustring 2$ 
Each command has a one or two letter code which identifies it. These codes 
will be discussed in detail in Section 3.3. 



Some commands may optionally be preceded by an argument, org. Arguments 
are signed integers in the range: 

0 < \arg' <_ 204? 

Arguments are taken as decimal numbers unless preceded by a quotation mark. 
A quotation mark causes the number to be interpreted as octal. For example, 
the following commands are equivalent* 

66M and : *102M 

Certain commands require one or two strings of characters as operands . 
If a string is given, it must be terminated by an escape character. 

3*2.2 Command String 

The Editor executes a command string as opposed to individual commands. 

The format of a command string is : 

emruL armdr, . , , ornnd $$ 
1 2 n 

Crrmd. represents a command as described in Section 3.2.1. Command strings 
are terminated b?y two consecutive escape codes. If amnd A ends with an escape 
code, only one escape is needed to terminate the command string. The Editor 
will not begin execution of any command within the string until the command 
string is terminated. For example, 

-13B is not executed but -1353$ is executed. 
Carriage returns are ignored in the command string and may therefore be used 
to continue a command string on a new line. 

3.3 Comman d Descriptions 

3-3.1 Read (yank) a Page 

To read a new page into memory, the following command Is given: 



The argument, if used, is ignored. The next page of the input file is read 
into the edit buffer. The previous contents of the edit buffer are destroyed, 
After execution of the command, CP resides before the first character of the 
new page, 

3-3.2 Append a Page 

To append a page to the edit buffer the following command is given: 

argk 

The argument, if used, is ignored. The next page of the input file is 
appended to the end of the present edit buffer. After execution of the 
command, CP resides before the first character of the appended page. 

3-3.3 Output (punch) the Buffer 

To output contents of the edit buffer, the following command is issued: 

argV or araPW 

The effect of this command is summarized below. 

argum ent effect 

0 or none output the entire edit buffer to the 

output file 

n > $ output n lines, starting at CP; in no 

case output past the end of buffer 

n < 0 illegal 

If P instead of PW is used, a form feed character is punched as the final 

character. If PW is used, no form feed is punched. This command has no 

effect on CP. For example, assume the edit buffer contains the following: 

LIFEOl ), LlIJEna ), LINE D 3 P 



The table "below shews the affect of various outtmt commands . 



Command 



2?W$$ 



Outimt^ 

LINE Dl ^ LINE 02 I LINE 0 3 ^ F 

E 02 ), 

ED2 ^ LINE 3 f p 
E O 2 ^ LINE 3 ^ 



A common command sequence used when no modification to a page is necessary is 

YP$$ 

3 . 3 . k Output Leader or Form Feed 

To output form feed or leader, the following command is issued: 

argF 

The effect of this command is summarized below. 



argument 
0 or none 
n > 0 

n < 0 

This command has no effect on CP. 



effect 
output a form feed 

output u inches of leader (nulls ) if 
n < 100 - output 100 inches of leader 
if n ^ 100. 

ill\-~r.l 



3.3.5 Output and Read 

The output and read function described in 3.3.3 may be accomplished by 
the following command: 



Its effect is summarized below, 
argument 
0 or none 
n > 0 
n < 0 



czrg? 

effe ct 
perform the command PY 
per fen- the command PY n times 
illegal 



p is used to represent a form feed character. 



CP points to the beginning of the last page read into the edit buffer after 

execution is complete . 

3-3.6 Examine (type out ) the Buffer 

To examine contents of the edit buffer on the teletype, the following 

command is issued: 

argT 

The effect of this command is summarized below. 

argument effect 

0 or none type the entire edit buffer cut on the 

teletype 

n > 0 tvpc out n lines , starting at CP; in no 

case type past the end of buffer 

n < 0 illegal 

This command has no effect on CP. 

3.3.7 Move CP to the Beginning of the Buffer 

The following command positions CP to the beginning of the buffer: 

argB 

If an argument is specified, it is ignored. 

3.3.8 Move CP to End of Buffer 

The following command positions CP to the end of the buffer : 

argZ 

If an argument is specified, it is ignored. 

3.3.9 Move CP 



CP may be moved from its current position by means of the following 

command : 



ar~uiient effect 
0 or none no effect 

n > 0 move CP forward v. character positions , 

but never past the end of the buffer 

n < 0 move CP back n character positions , bu 

never past the beginning of the buffer 

Assume the buffer looks as follows: 

ADD02,3, SZC I LAB: □ STA O 3 9 CNST \ 

t 

CP 

The M command can effect the following: 

command effect 

3M ADD O 2, 3, SZC J, LAB : O STA D 3 , CNST ^ 

t 

CP 

- 2M ADD C2..3 : .3ZC I LAE : D STA D 3 , CNST \ 

CP 

U0H ADD Q 2, 3, SZC I LAB : OSTA Q 3 ,CNST l 

t 

CP 

3.3.10 Delete Character s 

To delete characters from the buffer, the following command can be 

issued: 

argD 

This command is treated exactly as the M command, but in addition all 

characters which are passed over in the process of moving C? are deleted, 

3.3-11 Move CP to Beginning of a Line 



To move CP to the beginning of a line, the following: command can be 



The effect of this command is summarized belov, 

argument effect 

n > $ move CP forward past n carriage returns 

0 or none move CP backward past a carriage return, 

then forward one character 

n < P move CP backward \n) + 1 carriage returns, 

then forward one character 

This command always positions CP to the beginning of a line. The command 0L 

positions CP to the beginning of the line where CP resides. 

To move CP to the beginning of a line after first positioning CP to 

the beginning of the buffer, the following can be given: 

avgJ 

This command is equivalent to the command string 

Barg-1L 

If a 0 or negative argument is given, CP is merely positioned to the beginning 
of the buffer . 

3.3.12 De lete Lines 

To delete lines from the buffer, the following command can be issued: 

argK 

This command is treated exactly as L, but the lines passed over are deleted. 
The effect of this command is illustrated below. 

Initial Buffer a 



LINE Q 1 a LIKE a? \ 
CP 



ana btrmg Now Buffer 

-1K$$ LINE O 2 ), 

f 

CP 



LDA C-2,30 KJ0MG 2j 3,SZR ), l K $$ WAQ2, 3 0 k COM O 2 



IDA ii 2, 30 I COM no -? R7p <*W:4; r „ A _ . . 



3 
f 

CP 



P 
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3. 3.13 Ins ert Characters 

To insert characters into the buffer, the following; command can "be 

gi ven ; 

Is tring$ 

The string is inserted into the buffer at the position of CP. After insertion, 
CP is positioned to the right of the last character inserted. 
An alternate form for inserting one character is: 

avgl 

The argument is masked to seven bits and inserted, 

3 • 3 . 1^ String Searches 

The Editor will perform a search of the buffer for a specified stria? 
if the following command is issued: 

Sctringo 

The Editor searches forward for string from the current CP position. If found, 

CP will be positioned after the last character of the first occurrence of 

string. If the end of the buffer is reached without finding string, a message 

will be printed indicating this (§5). CP will be repositioned to the start of 

the edit buffer in this case. Some examples using the search command are: 

3lfore_ Cormiand String After 

LINE 0 1 > LINE Q2 h siimU LINEOl V LINE 02 I 

CP 

CP 

LINECl ). LINED2 SEC2$-2D»* LIIffi0l j. LINE j. 



t 

CP 



t 

CP 



LINE f 1 LINE D 2 J, S2$-1DI1A$ 151$* LINE Dl > LIKE D 1A > ^ 

A 

CP 

CP 

A search for a strinf hp f . r ,„+^ n „,,j , „ , . 

" n f- — / Dc continued if not found m the current edit 

buffer by examining subsequent pa^es of the inn-t "lie tm* ^ - ■ 
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c ailed for by: 

Msiring$ 

If the string is not found in the current buffer , the Editor executes a 
"PY U and continues its search at the beginning of the new buffer. This 
process is repeated until the string is found or the input file is exhausted. 
If the latter is the case, a message will be printed indicating this, 

A search for a string nay be continued if not found in the current edit 
buffer by examining subsequent pages of the input file but without punching 
the pages before that page in which the string is found. This type of search 
is called for by 

Q,string$$ 

If string is not found in the current edit buffer , the Editor executes a ?, Y ?f 
and continues until the string is found or the input file is exhausted. If 
the latter is the case, a message will be printed indicating this fact. This 
command is identical to "N"' except that the edit buffers unsuccessfully searched 
are not punched, 

3*3.15 Change a String 

A search for a string followed by a deletion of that string (if found) and 
an insertion of a second string may be effected by: 

Cs tringl $s tring2$ 

String 1 is replaced by string2 and CP is positioned to the first character 

after string?. If the end of the edit buffer is reached before stringl Is found, 

a message will be printed indicating this. Note that CstringlU merely deletes 

stringl, 

3.3.16 C opy Remainder of Inp ut Fi le 

If the command "B" (end) is given, the current edit buffer will be outputted 
(unless empty) as well as the remainder of the Input file. If an edit on an 



input file is complete , !, E ;i can be issued to copy the remainder of the input 

file into the output file. 

3.h Special Ac tion Characters 

Certain characters that appear in the command string cause special action 
by the Editor. These commands are single character, non-alphabetic codes. 

3.^.1 Nu mber of Ch aracters in Buffer 

If is encountered in the command string, the decimal number of 
characters presently in the buffer will be printed on the teletype. 

3 . J + . 2 Number of Lines in B uffer 

If ":" is encountered in the command string, the decimal number of lines 
in the buffer will be printed on the teletype. 

3.^.3 Number of Current Lane 

If " is encountered in the command string, the decimal line number in 
which CP resides will be printed on the teletype. For example, 

15J.$$ 

will cause 0015 to be typed (since CP points to the beginning of line 15). 

3 . k . U Insert with Tab 

If a tab character (+1) is encountered in the command string, it will 

t 

be interpreted exactly as if la had been encountered, ie s tab is an implicit 

b 

insert c ommand . 

3.^.5 Last. Cb enactor Delete 

Before a command string has been terminated, it is possible to delete 
characters from the string. If 3\J3 OUT is depressed at any time during input 
of the command string, the last character entered in the string will be deleted 

The Editor will also transmit back the character which was deleted. 



Assume the following string has been typed; 

I TEXT 

If RUB OUT is now depressed twice and the command terminated, the teletype 
copy will appear as follows : 

ITEXTTX$$ 

and only the characters TE will he inserted, 

3.^.6 Erase or Stop Command Execution 

The special character tC can be used in two ways. If encountered before 
a command string is terminated, the entire string is deleted, and the user 
may begin again. If encountered after a command string is terminated, but 
before a new one has been requested (§U) S the Editor stops execution of the 
present command string, stops punching or typing, resets CP to the beginning 
of the edit buffer, and requests a now command string, 

3.^.7 Beset for In put 

If more than one input tape is used, the special character +T should be 
typed between tapes. This character performs the same function as tC and 
in addition stops the input device and clears the input buffer. A new tape 
may now be mounted in the input device, 

h. One-rating Procedure 

k , 1 General 

An object tape of the Editor will be provided with the standard NOVA 
software package. This object tape must be loaded by the binary loader 
(§093-000003). Once loaded, control will be transferred to the Editor, The 
Editor will delete its edit and input buffers and request the user to assign 
) his input and output files. The Editor first requests the output device by 

TTO(l) OR FTP (2)? 
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Th e user should respond by depressing 1 for teletype output or 2 for high 
speed punch output. The input device is requested by : 

TTI(1) OR PTP(2j? 

Respond with 1 for teletype input or 2 for high speed reader input. If the 
user wishes to punch his output tapes with parity, he should respond with 
1 to the next question: 

PARITY 0UT(1) OR HOT ( 2 ) ? 
Finally, if the input tapes are punched with parity, the user should respond 
with 1 to the last question: 

PARITY IK(1) OR N0T(2)? 
Once the I/O devices have been assigned, the Editor will request a command 
string by typing on the teletype. The user may now enter a command string 
which will be executed upon termination, A new command string may be given 
after the Editor again types This procedure is repeated until the update 

is complete. 

If it is necessary to reassign the input/output files and delete the 
buffers, perform the following: 

1. Press RESET 

2. Enter 000002 in the data switches 

3. Press START 

If it is necessary to force the Editor to request a command string but 
not to affect the I/O assignments or current edit buffer, perform the following: 

1. Press RESET 

2. Enter 000003 in the data switches 

3. Press START 



-lU- 

h.2 Input 

Three characters are ignored on input by the Editor. These characters 

are : 

Character Octal Value 

null 000 
line feed 012 
rub out ITT 

Although line feed is ignored on input, the Editor will provide a line feed 

after every carriage return sent to the output file. 

If parity is checked on input, a message will be printed on the teletype 

if a character read foils parity. The message gives the line number in which 

the parity error occurred, and the character in error will be represented by 

a "\ character. If the line number is n, the line nay be examined by: 

nJIT$$ 

k . 3 Editor Output to Teletype 

3.1 Invisible Characters 

Any invisible character which the Editor transmits to the teletype will 

be visibly represented as an up arrow followed by the printing character which 

C 

corresponds to the invisible character. For example, if the user inserts a TG , 

R 

the Editor will respond with +G to the teletype. L 

4.3.2 Tab and Form Feed 

A switch in the Editor is examined to determine whether to simulate tabs 

with spaces. If tabs are simulated, the predefined tab positions occur at 
columns 1, 9, IT, 25, etc. This switch is initialized to simulate tabs. It 
may be complemented, causing the Editor to supply the actual tab character to 
the teletype,, by typing a +P in a command string. Each occurrence of +F causes 
the switch to be complemented, thus tP +F has no effect. 



k.k Teletype Selected as Output File 

A problem arises if the teletype is used both for command input and the 
output file. If the punch is left in the "ON" position while typing Editor 
commands, these characters are punched as part of the output. The Editor 
resolves this problem in the following way. Before transmitting S '*' T to 
indicate .an Editor command is called for, the Editor will halt with the 
Carry light off. This signals the user to turn the teletype punch OFF. After 
doing this , the user can press CONTINUE, causing the Editor to now request a 
command. After a command string is terminated, the Editor determines whether 
output is to occur. If it is, it again halts, this time with the Carry light 
on. This signals the user to turn the punch ON and press CONTINUE, causing 
the output to be punched. This process is repeated between commands and output 
updates, thus avoiding the interference problem. 

5 • Error Detection 

Various errors can occur during the editing process . An error message 
will be given to indicate the type of error. These messages are discussed 
below. 

5 . 1 Unsucc essful String Search 

If a string search is initiated and the Editor is unable to locate the 
string, the following will be printed: 

STB NOT FOUND 

The user should check his command to make sure the string he is searching for 
Is specified correctly. 

5 . 2 P arity Error on Input 

If a parity error is detected while reading, the following will be printed 

PARITY ERROR IN LINE NUMBER dddd 



Where dddd represents the line number in which the error occurred, When this 
line is examined, the character in error vill have "been replaced by "\' ! . 

5 . 3 Edit Bu ffer Capa city Exceeded 

If a user attempts to append a page to a buffer that is full, the 
following message will be printed: 

BUFFER IS FULL- CANNOT BO A 
The user should output the present buffer to enable reading of additional 
pages . 

During the reading of a page, the buffer capacity may be exceeded. The 

following message will be typed: 

BUFFER IS FULL-Y OR A INPUT TERMINATED 

This indicates a partial page has been read into (or appended to) the edit 

buffer. This buffer must be output ted. or sections deleted, before the rest 

^ of the page can be read. 

Since the command string also requires storage, it is possible for the 

command string storage to approach overlap with the edit buffer. If this 

should occur, the following will be printed: 

BUFFER CAFACITY EXCEEDED DURING CO.MMAND INPUT 
COMMAND IS TERMINATED AND BEING EXECUTED. 

The Editor begins execution of the command string as if It had received two 

escape characters. Upon completion of the execution, the user can continue 

his edit from where it was terminated. 

5 • Questionable Command 

If at any point the Editor is unable to understand a command, It will 

remainder of questionable command string 
The portion of the command string which has not been executed should be examined 
to determine the incorrect command. The user may continue by correcting the 
command and starting from the point at which execution ceased. 
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Edit Af fectinc Commands ( cent . ) 



z r l 




T?iin <*>+• "J on 


R 


nE 


X s-X J. UX III A O, /i wxiucis 


S 






T 


T 
nT 


Type entire edit buffer 
Type n lines from current CP 


Y 


Y 


Yank a page into the edit buffer 


Z 


Z 


Position CP to end of edit buffer 



Special Action Commands 



Command 


Function 




Print number of characters in edit buffer 


; 


Print number of lines in edit buffer 


• 


Print line number where CP resides 


+1 (tab) 


Interpret as la. 

b 


RUB OUT 


Erase last character 


+C 


Erase command string or halt execution of 
command string 


+T 


Reset, input buffer and stop input device 



Edit Affecting Commands 




Command 


Form 


Function 


A 


A 


Append a page to the- edit buffer 


B 


3 


Position CP to the beginning of the edit 
buffer 


C 


Cs tring l$s tring 2$ 


Change string 1 to 3 tring 2 


D 


nD 


Delete n characters starting at CP 


F 


F 


Punch a form feed 




nF 


Punch n inches of leader (n < 100) 


I 


nl 
Is tring $ 


Mask n to seven bits and insert at CP 
Insert string starting at CP 


J 


nJ 


Jump n lines from beginning of edit buffer 


K 


nK 


Delete (kill) n lines from current CP 


.4 


nL 


Position CP n lines from current CP 


M J 


rcM 


Position (move) CP n characters from current CP 


N i 

1 
1 


llstring§ 


Search for string ; if not found, punch, read, 

and continue search 


P 


P 


Punch entire edit buffer followed by a form 
feed 




nP 


Punch n lines from current CP followed by a 
form feed 


PW | 

i 


PW 
n?V 


Punch entire edit buffer 
Punch n lines from current CP 



